FluentCart 支付宝付款网关插件：WPKJ FluentCart Alipay Payment

共计 1481 个字符，预计需要花费 4 分钟才能阅读完成。

FluentCart 是最近发布的一款性能至上、自托管的 WordPress 电商平台插件。为了方便国内用户使用，倡萌专门开发了 FluentCart 支付宝付款网关插件：WPKJ FluentCart Alipay Payment 。

支付宝插件功能特点

支持支付宝主流接口

WPKJ FluentCart Alipay Payment 自动检测用户环境并选择最佳支付界面：

• PC 网站端支付– 在电脑网站端，传统的跳转到支付宝界面付款
• 移动 WAP 支付 – 在手机端浏览器直接唤起支付宝付款
• 当面付 – 在电脑端可以开启当面付功能，直接显示二维码，扫码付款
• 支付宝 App 支付– 原生 App 支付体验 （还未实际测试）

支持 FluentCart 订阅功能，实现周期付款 （仍需完善）

全面的订阅付费支持，双模策略：

自动续订 （定期协议）⭐推荐

• 通过支付宝协议实现真正的自动续费
• 需要商家激活签约激活定期付款服务

手动续订 （备用模式）

• 客户手动完成每次续订付款
• 无特殊商户要求
• 如果协议失败则自动回退
• 完整的 FluentCart 订阅功能集成

支持自动退款

• 自动退款：订单取消 = 立即退款
• 手动退款：后台操作 （待开发完善）
• 全部和部分：支持两种退款类型 （待开发完善）
• 活动记录：所有退款均在订单日志中跟踪
• 可配置：根据需要启用 / 禁用自动退款

开发者功能

• 测试模式：内置开发沙盒模式，方便测试
• 详细日志记录：带有全面日志的调试模式
• Webhook 集成：实时付款通知
• 清洁架构：PSR-4 自动加载、命名空间
• Hooks & Filters：内置必要的钩子

安装环境要求

• WordPress：6.5 或更高版本
• PHP：8.2 或更高版本
• FluentCart：1.2.0 或更高版本
• SSL 证书：生产需要 HTTPS
• 支付宝账户：支付宝开放平台商户账户

支付宝插件安装

WPKJ FluentCart Alipay Payment 插件完全免费发布，后期会提交到 WordPress 官方插件库。目前可以通过以下方式安装。

  下载 WPKJ FluentCart Alipay Payment

1. 在 WP 后台，插件 - 安装插件，上传插件 zip 包进行安装、激活
2. 导航至 FluentCart → 设置 → 付款方式
3. 配置支付宝凭证并启用网关
4. 在支付宝仪表盘配置 webhook URL

支付宝插件配置

步骤 1：获取支付宝凭证

1. 在支付宝开放平台 注册开发者账号
2. 创建新应用程序，开通网站端支付、移动端支付、当面付 （可选）
3. 生成 RSA2 密钥对 （应用公钥和 应用私钥）
4. 将应用公钥上传至支付宝后台，生成 支付宝公钥
5. 记下你的 16 位 App ID

步骤 2：插件配置

支持 Live 模式和 test 模式，具体配置界面如下：

Live 上线凭证

• APP ID：您的 16 位应用程序 ID
• 应用程序私钥：您的 RSA 私钥
• 支付宝公钥：支付宝的 RSA 公钥

Test 测试凭证

• 测试 APP ID：沙盒应用程序 ID
• 测试私钥：沙盒 RSA 私钥
• 测试公钥：沙盒支付宝公钥

订阅设置 （可选，带完善）

对于自动续订的定期付款：

1. 启用定期付款：勾选该选项
2. 个人产品代码：输入支付宝的代码 （通常 GENERAL_WITHHOLDING_P）
3. 商户协议：确保在支付宝后台签约周期代扣服务

注意：如果没有签约支付宝的周期代扣服务，将使用手动续订模式。

设置自动取消订阅：选中后，取消初始订阅订单将自动取消订阅

其他设置

• 通知 URL：复制并在支付宝后台配置
• 启用自动退款：勾选即可启用自动退款
• 启用当面付：启用二维码扫码支付